home *** CD-ROM | disk | FTP | other *** search
/ Best Tools for JAVA / Best Tools for JAVA.iso / CONVERTR / MHONARC / DESC.TXT next >
Encoding:
Text File  |  1995-09-11  |  4.8 KB  |  145 lines
  1. ---------------------------------------------------------------------------
  2.  
  3.  
  4.  
  5. [Image]MHonArc
  6.  
  7.  
  8.  
  9. An E-mail-to-HTML converter
  10.  
  11.  
  12.  
  13. ---------------------------------------------------------------------------
  14.  
  15.  
  16.  
  17. Contents
  18.  
  19.  
  20.  
  21.    * What's New
  22.  
  23.    * What is MHonArc?
  24.  
  25.    * Why Use MHonArc?
  26.  
  27.    * Examples
  28.  
  29.    * Availability
  30.  
  31.    * More Information
  32.  
  33.    * Open bugs
  34.  
  35.    * Extras
  36.  
  37.  
  38.  
  39. ---------------------------------------------------------------------------
  40.  
  41.  
  42.  
  43. What's New
  44.  
  45.  
  46.  
  47. What's New last Updated: Thu Apr 20 15:59:16 PDT 1995
  48.  
  49.  
  50.  
  51. MHonArc 1.1 is now available. New features include:
  52.  
  53.  
  54.  
  55.    *  Run on Unix or MS-DOS platforms
  56.  
  57.    *  Thread index
  58.  
  59.    *  Remove messages from an archive
  60.  
  61.    *  List contents of archive to standard out
  62.  
  63.    *  Restrict size of an archive
  64.  
  65.    *  Detection of already archive messages during add operation
  66.  
  67.    *  More customization features
  68.  
  69.    *  Added more variables for use in user defined mailto URLs
  70.  
  71.    *  Bug fixes
  72.  
  73.  
  74.  
  75. ---------------------------------------------------------------------------
  76.  
  77.  
  78.  
  79. What is MHonArc?
  80.  
  81.  
  82.  
  83. MHonArc is the successor of mail2html, a Perl mail-to-HTML converter.
  84.  
  85. MHonArc works in a very simliar manner as mail2html (HTML mail archiving
  86.  
  87. with index, mail thread linking, etc), but with much more capabilities
  88.  
  89. including full support for MIME, as defined in RFC 1521, and powerful user
  90.  
  91. customization features..
  92.  
  93.  
  94.  
  95. ---------------------------------------------------------------------------
  96.  
  97.  
  98.  
  99. Why Use MHonArc?
  100.  
  101.  
  102.  
  103. Here are some reasons for using MHonArc:
  104.  
  105.  
  106.  
  107.    * You want to keep organized archives of mail messages and/or news
  108.  
  109.      articles for a World Wide Web (WWW) server; complete with live
  110.  
  111.      hypertext pointers to their authors and to any url's mentioned.
  112.  
  113.    * You would like to control the layout of mail/news archives to keep a
  114.  
  115.      consistent style to your WWW pages.
  116.  
  117.    * You have a WWW client, but no MIME mail reader. MHonArc will allow you
  118.  
  119.      to read MIME messages that includes images, audio, video, etc via your
  120.  
  121.      Web client.
  122.  
  123.    * Muli-platform support: MS-DOS and Unix.
  124.  
  125.    * You think the MHonArc logo is really cool, and it deserves to be used.
  126.  
  127.    * You like Perl, and you want to see what it can do.
  128.  
  129.    * Just cuz.
  130.  
  131.  
  132.  
  133. ---------------------------------------------------------------------------
  134.  
  135.  
  136.  
  137. Examples
  138.  
  139.  
  140.  
  141. To see the type of output generated by MHonArc, check out the sample
  142.  
  143. archive of some newsgroup posts from comp.infosystems.www.authoring.cgi.
  144.  
  145.  
  146.  
  147. MIME
  148.  
  149.  
  150.  
  151. MHonArc can handle MIME encoded messages. See an example MIME message
  152.  
  153. processed.
  154.  
  155.  
  156.  
  157. ---------------------------------------------------------------------------
  158.  
  159.  
  160.  
  161. Availability
  162.  
  163.  
  164.  
  165. Unix
  166.  
  167.      The latest version of MHonArc is 1.1. You can get MHonArc in
  168.  
  169.      tar-gzipped file via HTTP or FTP (199889 bytes).
  170.  
  171.  
  172.  
  173. MS-DOS
  174.  
  175.      MHonArc for MS-DOS is available in a ZIP file via HTTP or FTP (244002
  176.  
  177.      bytes)
  178.  
  179.  
  180.  
  181.      Special Note for MS-DOS users:
  182.  
  183.         o IMPORTANT: You must preserve the subdirectory structure of the
  184.  
  185.           .zip archive when unzipping MHonArc. Use the -d option if you are
  186.  
  187.           using pkunzip.
  188.  
  189.  
  190.  
  191. ---------------------------------------------------------------------------
  192.  
  193.  
  194.  
  195. More Information
  196.  
  197.  
  198.  
  199. To get the complete lo-down on MHonArc, read the documentation that is
  200.  
  201. included in the distribution.
  202.  
  203.  
  204.  
  205. ---------------------------------------------------------------------------
  206.  
  207.  
  208.  
  209. Open Bugs
  210.  
  211.  
  212.  
  213. Bug list last updated: Thu Aug 17 13:53:28 PDT 1995
  214.  
  215.  
  216.  
  217. List of open bugs for version 1.1:
  218.  
  219.  
  220.  
  221.    * The month is off by -1 of the real month in the -scan output.
  222.  
  223.  
  224.  
  225.    * The following example invocations are incorrect in the Synopsis
  226.  
  227.      section of the Overview:
  228.  
  229.  
  230.  
  231.      % mhonarc -add [options] < mhfolder ...
  232.  
  233.      % mhonarc -add -mbox [options] < mailbox
  234.  
  235.  
  236.  
  237.      The previous will not work, and may cause unexpected results.
  238.  
  239.  
  240.  
  241.    * Message IDs with single quotes causes the .mhonarc.db to contain
  242.  
  243.      illegal Perl code, leading to subsequent add operations to fail.
  244.  
  245.      Basically, the single quotes are not escaped properly for keys of an
  246.  
  247.      associative array.
  248.  
  249.  
  250.  
  251.    * Spaces are not escaped properly when custom mailto URL is defined.
  252.  
  253.  
  254.  
  255. ---------------------------------------------------------------------------
  256.  
  257.  
  258.  
  259. Extras
  260.  
  261.  
  262.  
  263. HtmlMail
  264.  
  265.      Program to pipe a mail/news message to a WWW client. See comments at
  266.  
  267.      beginning of source file on how to use it.
  268.  
  269.  
  270.  
  271. MosaicMail
  272.  
  273.      A Perl program to load in a mail message into an existing Mosaic for X
  274.  
  275.      session. MHonArc is called to do the actual mail-to-HTML conversion.
  276.  
  277.      MosaicMail can also be used to pipe newsgroup posts into Mosaic from
  278.  
  279.      your newsreader. Handy for making URLs hyperlinked, or processing MIME
  280.  
  281.      posts.
  282.  
  283.  
  284.  
  285. ---------------------------------------------------------------------------
  286.  
  287. Earl Hood <ehood@convex.com>
  288.  
  289.